package org.example.mapper;

import org.example.entity.ShortUrl;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 短链接Mapper接口
 * 
 * @author Your Name
 * @since 2024-07-01
 */
@Mapper
public interface ShortUrlMapper {
    
    /**
     * 插入短链接
     * 
     * @param shortUrl 短链接实体
     * @return 影响行数
     */
    int insert(ShortUrl shortUrl);
    
    /**
     * 根据短链接编码查询
     * 
     * @param shortCode 短链接编码
     * @return 短链接实体
     */
    ShortUrl selectByShortCode(@Param("shortCode") String shortCode);
    
    /**
     * 根据原始链接查询
     * 
     * @param originalUrl 原始链接
     * @return 短链接实体
     */
    ShortUrl selectByOriginalUrl(@Param("originalUrl") String originalUrl);
    
    /**
     * 更新访问次数
     * 
     * @param shortCode 短链接编码
     * @return 影响行数
     */
    int updateAccessCount(@Param("shortCode") String shortCode);
    
    /**
     * 更新短链接状态
     * 
     * @param shortCode 短链接编码
     * @param status 状态
     * @return 影响行数
     */
    int updateStatus(@Param("shortCode") String shortCode, @Param("status") Integer status);
    
    /**
     * 查询所有短链接
     * 
     * @return 短链接列表
     */
    List<ShortUrl> selectAll();
    
    /**
     * 分页查询短链接
     * 
     * @param offset 偏移量
     * @param limit 限制数量
     * @return 短链接列表
     */
    List<ShortUrl> selectByPage(@Param("offset") int offset, @Param("limit") int limit);
    
    /**
     * 统计总数
     * 
     * @return 总数
     */
    int countTotal();
    
    /**
     * 删除短链接
     * 
     * @param shortCode 短链接编码
     * @return 影响行数
     */
    int deleteByShortCode(@Param("shortCode") String shortCode);
}
